{
	"info": {
		"_postman_id": "051bed97-6361-4bf2-96f6-6bb483144d94",
		"name": "AudioPPD-API Demo Client",
		"description": "Hier werden über den Demo-Klienten die Tarifgenerationen 20/21 für die drei MSW-Testsender abgerufen. In den einzelnen Requests mit Rückgabe als Xml werden stichpunktartig die jeweiligen Inhalte erläutert. Für den eigentlichen Datenabruf sollte aber die Json-Version verwendet werden.",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
	},
	"item": [
		{
			"name": "MSW-Testsender 1 ( 802685 )",
			"item": [
				{
					"name": "Paket 802685-2022 als Xml abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802685/2022/JahresInfosAlsXml",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802685",
								"2022",
								"JahresInfosAlsXml"
							]
						},
						"description": "# Überblick\n- es gibt einen nationalen Vermarkter\n- prozentuale und ausgerechnete Ab- und Zuschläge\n- Sonderwerbeformen\n\n## Sender-Ebene\n- reguläre ganzjährige Spotpreise beim Sender\n- Differenzierung nach Wochentagen \"Mo-Fr\" und \"Sa+So\" \n- prozentuale Ab- und Zuschläge für Früh-/Spätbucher und Single-Spots\n- Adressen und Hinweise\n\n## Nationale Vermarktung\n- ausgerechnete Single-Spots beim nationalen Vermarkter, die überschreiben diejenigen per Zuschlag ausrechenbaren Preise auf Sender-Ebene\n- Evening-Offer als zeitlich begrenzt gültige Sonderwerbeform\n- prozentuale Zuschläge für Erst- und Letztplatzierung mit Rangfolgen"
					},
					"response": []
				},
				{
					"name": "Paket 802685-2022 als Json abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802685/2022",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802685",
								"2022"
							]
						},
						"description": "Liefert die Daten für das Tarifjahr 2021 als Json-Objekt"
					},
					"response": []
				},
				{
					"name": "Paket 802685-2021 als Xml abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802685/2021/JahresInfosAlsXml",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802685",
								"2021",
								"JahresInfosAlsXml"
							]
						},
						"description": "# Überblick\n- reguläre Spotpreise beim Sender, mit monatlich abweichenden Preisen für jeden Wochentag separat und korrespondierenden Durchschnittspreisen\n- separate Vorgaben für jeden einzelnen deutschen Feiertag\n- Adressen und Hinweise beim Sender und Vermarkter\n- zusätzlich beim Vermarkter noch Schlusstermine und Skonti"
					},
					"response": []
				},
				{
					"name": "Paket 802685-2021 als denormalisiertes Json abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802685/2021?datenFormat=1",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802685",
								"2021"
							],
							"query": [
								{
									"key": "datenFormat",
									"value": "1"
								}
							]
						},
						"description": "Liefert die Daten für das Tarifjahr 2021 als Json-Objekt, wobei hier alle Schlüssel / Typen-Ids aufgelöst sind"
					},
					"response": []
				},
				{
					"name": "Denormalisierte Preise als Excel holen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v5/Sender/802685/2022/DenormalisiertePreise?alsExcelDatei=true",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v5",
								"Sender",
								"802685",
								"2022",
								"DenormalisiertePreise"
							],
							"query": [
								{
									"key": "alsExcelDatei",
									"value": "true"
								}
							]
						}
					},
					"response": []
				},
				{
					"name": "Denormalisierte Preise für 2019 als Json holen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v6/Sender/802730/2019/DenormalisiertePreise",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v6",
								"Sender",
								"802730",
								"2019",
								"DenormalisiertePreise"
							]
						}
					},
					"response": []
				}
			],
			"description": "Erster Testsender vom MSW"
		},
		{
			"name": "MSW-Testsender 2 ( 802730 )",
			"item": [
				{
					"name": "Paket 802730-2021 als Xml abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802730/2021/JahresInfosAlsXml",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802730",
								"2021",
								"JahresInfosAlsXml"
							]
						},
						"description": "# Sender\n- Vorgaben pauschal für alle Feiertage\n- reguläre ganzjährige Spotpreise beim Sender\n- prozentualer Zuschlag für Single-Spots\n# Vermarkter ( national )\n- ausgerechnete Single-Spot Preise\n- spezielle Werbeform \"Flexi-Spots\" mit zusätzlichen Meta-Infos bei dieser Werbeform"
					},
					"response": []
				},
				{
					"name": "Paket 802730-2020 als Xml abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802730/2020/JahresInfosAlsXml",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802730",
								"2020",
								"JahresInfosAlsXml"
							]
						},
						"description": "# Überblick\n- Reguläre Spotpreise beim Sender mit Wochentagsschemata \"Mo-Fr\", \"Sa\" und \"So\" und regulärem 24-Stunden Raster. \n- Zusätzlich wurden hier SpotlängenIndices beim Sender hinterlegt.\n- Unterschiedliche Mengenstaffeln bei den beiden Vermarktern."
					},
					"response": []
				},
				{
					"name": "Paket 802730-2021 als Json abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802730/2021",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802730",
								"2021"
							]
						}
					},
					"response": []
				},
				{
					"name": "Denormalisierte Preise als Json holen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v5/Sender/802730/2019/DenormalisiertePreise",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v5",
								"Sender",
								"802730",
								"2019",
								"DenormalisiertePreise"
							]
						}
					},
					"response": []
				},
				{
					"name": "Denormalisierte Preise als Excel holen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v5/Sender/802730/2019/DenormalisiertePreise?alsExcelDatei=true",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v5",
								"Sender",
								"802730",
								"2019",
								"DenormalisiertePreise"
							],
							"query": [
								{
									"key": "alsExcelDatei",
									"value": "true"
								}
							]
						}
					},
					"response": []
				},
				{
					"name": "Paket 802685-2019 als Xml abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802730/2019/JahresInfosAlsXml",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802730",
								"2019",
								"JahresInfosAlsXml"
							]
						}
					},
					"response": []
				},
				{
					"name": "Denormalisierte Preise hochladen",
					"request": {
						"method": "POST",
						"header": [],
						"body": {
							"mode": "raw",
							"raw": "{\r\n    \"Preise\": [\r\n        {\r\n            \"vermarkterId\": 0,\r\n            \"senderId\": 802730,\r\n            \"giltAb\": \"2019-01-01\",\r\n            \"giltBis\": \"2019-12-31\",\r\n            \"kuerzel\": \"ganzjährig 2019\",\r\n            \"rangfolge\": 0,\r\n            \"wochentageBF\": 31,\r\n            \"werbeformTypId\": 3001,\r\n            \"preistypId\": 701,\r\n            \"uhrzeitAb\": \"00:00:00\",\r\n            \"uhrzeitBis\": \"23:59:59\",\r\n            \"preisInWaehrung\": 3.17,\r\n            \"rabattFaehigkeitenBF\": 1,\r\n            \"provisionsFaehigkeitenBF\": 1\r\n        },\r\n        {\r\n            \"vermarkterId\": 0,\r\n            \"senderId\": 802730,\r\n            \"giltAb\": \"2019-01-01\",\r\n            \"giltBis\": \"2019-12-31\",\r\n            \"kuerzel\": \"ganzjährig 2019\",\r\n            \"rangfolge\": 0,\r\n            \"wochentageBF\": 127,\r\n            \"werbeformTypId\": 3000,\r\n            \"abweichendeBezeichnung\":\"Flexi-Preise ( Schieberecht )\",\r\n            \"preistypId\": 701,\r\n            \"uhrzeitAb\": \"00:00:00\",\r\n            \"uhrzeitBis\": \"23:59:59\",\r\n            \"preisInWaehrung\": 4.55,\r\n            \"rabattFaehigkeitenBF\": 0,\r\n            \"provisionsFaehigkeitenBF\": 1,\r\n            \"schieberecht\": 1\r\n        },\r\n        {\r\n            \"vermarkterId\": 0,\r\n            \"senderId\": 802730,\r\n            \"giltAb\": \"2019-01-01\",\r\n            \"giltBis\": \"2019-12-31\",\r\n            \"kuerzel\": \"ganzjährig 2019\",\r\n            \"rangfolge\": 0,\r\n            \"wochentageBF\": 31,\r\n            \"werbeformTypId\": 3002,\r\n            \"preistypId\": 701,\r\n            \"uhrzeitAb\": \"00:00:00\",\r\n            \"uhrzeitBis\": \"04:59:59\",\r\n            \"preisInWaehrung\": 2.30,\r\n            \"rabattFaehigkeitenBF\": 1,\r\n            \"provisionsFaehigkeitenBF\": 1\r\n        },\r\n        {\r\n            \"vermarkterId\": 0,\r\n            \"senderId\": 802730,\r\n            \"giltAb\": \"2019-01-01\",\r\n            \"giltBis\": \"2019-12-31\",\r\n            \"kuerzel\": \"ganzjährig 2019\",\r\n            \"rangfolge\": 0,\r\n            \"wochentageBF\": 31,\r\n            \"werbeformTypId\": 3002,\r\n            \"preistypId\": 701,\r\n            \"uhrzeitAb\": \"20:00:00\",\r\n            \"uhrzeitBis\": \"23:59:59\",\r\n            \"preisInWaehrung\": 2.00,\r\n            \"rabattFaehigkeitenBF\": 1,\r\n            \"provisionsFaehigkeitenBF\": 1\r\n        },\r\n        {\r\n            \"vermarkterId\": 0,\r\n            \"senderId\": 802730,\r\n            \"giltAb\": \"2019-01-01\",\r\n            \"giltBis\": \"2019-12-31\",\r\n            \"kuerzel\": \"ganzjährig 2019\",\r\n            \"rangfolge\": 0,\r\n            \"wochentageBF\": 96,\r\n            \"werbeformTypId\": 3001,\r\n            \"preistypId\": 701,\r\n            \"uhrzeitAb\": \"00:00:00\",\r\n            \"uhrzeitBis\": \"23:59:59\",\r\n            \"preisInWaehrung\": 1.20,\r\n            \"rabattFaehigkeitenBF\": 1,\r\n            \"provisionsFaehigkeitenBF\": 1\r\n        },\r\n        {\r\n            \"vermarkterId\": 0,\r\n            \"senderId\": 802730,\r\n            \"giltAb\": \"2019-11-18\",\r\n            \"giltBis\": \"2019-11-24\",\r\n            \"kuerzel\": \"abweichend Black-Friday 2019\",\r\n            \"rangfolge\": 1,\r\n            \"wochentageBF\": 127,\r\n            \"werbeformTypId\": 3001,\r\n            \"preistypId\": 701,\r\n            \"uhrzeitAb\": \"00:00:00\",\r\n            \"uhrzeitBis\": \"23:59:59\",\r\n            \"preisInWaehrung\": 5.05,\r\n            \"rabattFaehigkeitenBF\": 1,\r\n            \"provisionsFaehigkeitenBF\": 1\r\n        }\r\n    ]\r\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "https://{{api_base_address}}/v5/Sender/802730/2019/Vermarkter/0/Preise",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v5",
								"Sender",
								"802730",
								"2019",
								"Vermarkter",
								"0",
								"Preise"
							]
						},
						"description": "Hier werden einige senderspezifische ( Vermarkter-Id = 0 ) Preise hochgeladen.\n\nZur Demonstration werden hier für Mo-Fr zu bestimmten Zeiten Single Spot Preise definiert.  \nAußerdem wurden für die Black Friday Woche abweichende Preise spezifiziert."
					},
					"response": []
				}
			]
		},
		{
			"name": "MSW-Testsender 3 ( 802731 )",
			"item": [
				{
					"name": "Paket 802731-2021 als Xml abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1/Sender/802731/2021-01-01/InfosAlsXml",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1",
								"Sender",
								"802731",
								"2021-01-01",
								"InfosAlsXml"
							]
						},
						"description": "Demo zum Vermarkterwechsel im Laufe eines Kalenderjahres\n- Wechsel des Vermarkters im 2. Halbjahr\n- Unterschiedliche Zeiträume für verschiedene Werbeformen beim zweiten Vermarkter\n- spezieller Zuschlag für die Dauer der Fussball-EM 2021"
					},
					"response": []
				},
				{
					"name": "Aktuelles Paket 802731-2021 als Json abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1/Sender/802731?jahr=2021",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1",
								"Sender",
								"802731"
							],
							"query": [
								{
									"key": "jahr",
									"value": "2021"
								}
							]
						},
						"description": "Ruft den aktuellsten Stand der Tarifdaten für diesen Sender im Kalenderjahr 2021 ab"
					},
					"response": []
				},
				{
					"name": "Historie für 802731 abrufen",
					"event": [
						{
							"listen": "test",
							"script": {
								"exec": [
									"pm.test(\"Status test\", function () {\r",
									"    pm.response.to.have.status(200);\r",
									"});"
								],
								"type": "text/javascript"
							}
						}
					],
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802731/Historie",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802731",
								"Historie"
							]
						},
						"description": "Hier werden die historischen Datenstände für diesen Sender abgefragt"
					},
					"response": []
				},
				{
					"name": "Früheres Paket 802731-2021 als Json abrufen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802731/2021?standVom=2021-03-11",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802731",
								"2021"
							],
							"query": [
								{
									"key": "standVom",
									"value": "2021-03-11"
								}
							]
						},
						"description": "Hier wird ein historischer Datenstand ( vor dem Vermarkterwechsel ) abgerufen"
					},
					"response": []
				},
				{
					"name": "(Preislisten-)Zeiträume holen",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "https://{{api_base_address}}/v1.1/Sender/802731/Zeitraeume?typid=901",
							"protocol": "https",
							"host": [
								"{{api_base_address}}"
							],
							"path": [
								"v1.1",
								"Sender",
								"802731",
								"Zeitraeume"
							],
							"query": [
								{
									"key": "typid",
									"value": "901"
								}
							]
						},
						"description": "Hierüber werden die veröffentlichten Tarifgenerationen für diesen Sender abgefragt"
					},
					"response": []
				}
			],
			"description": "Bei diesem Sender wird ein Vermarkterwechsel im Frühjahr 2021 durchgeführt"
		},
		{
			"name": "Alle Typen holen",
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://{{api_base_address}}/v1.1/Typen/AlleTypen",
					"protocol": "https",
					"host": [
						"{{api_base_address}}"
					],
					"path": [
						"v1.1",
						"Typen",
						"AlleTypen"
					]
				},
				"description": "Holt alle verwendeten Typschlüssel in einem strukturierten Json-Fragment"
			},
			"response": []
		},
		{
			"name": "Alle Sender-Objekte holen",
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://{{api_base_address}}/v1.1/Sender?seitenGroesse=2000",
					"protocol": "https",
					"host": [
						"{{api_base_address}}"
					],
					"path": [
						"v1.1",
						"Sender"
					],
					"query": [
						{
							"key": "seitenGroesse",
							"value": "2000"
						}
					]
				},
				"description": "Holt alle für den Demo-Koienten freigeschalteten und veröffentlichten Sender-Objekte ohne untergeordnete Tarifdaten"
			},
			"response": []
		},
		{
			"name": "Sender suchen",
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://{{api_base_address}}/v1.1/Sender?suchbegriff=test",
					"protocol": "https",
					"host": [
						"{{api_base_address}}"
					],
					"path": [
						"v1.1",
						"Sender"
					],
					"query": [
						{
							"key": "suchbegriff",
							"value": "test"
						}
					]
				},
				"description": "Über diesen Endpunkt kann eine einfache Sendersuche durchgeführt werden, wobei hier nach Sender-Ids und dem Namen gesucht wird"
			},
			"response": []
		},
		{
			"name": "Zuletzt geänderte Sender(-Preislisten) holen",
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://{{api_base_address}}/v1.1/Sender/Preislisten?abZeitpunkt=2022-01-20",
					"protocol": "https",
					"host": [
						"{{api_base_address}}"
					],
					"path": [
						"v1.1",
						"Sender",
						"Preislisten"
					],
					"query": [
						{
							"key": "abZeitpunkt",
							"value": "2022-01-20"
						}
					]
				},
				"description": "**Hinweise**\n\nDieser Endpunkt dient der Abwärtskompatibilität und liefert die seit dem übergebenem Referenzdatum geänderten Jahrespakete als (Legacy) Preislisten ab, wobei bei der jeweils letzten Preisliste ein offenes Endedatum ausgegeben wird."
			},
			"response": []
		},
		{
			"name": "Legacy - Alle Senderpreislisten für Jahr holen",
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://{{api_base_address}}/v1.1/Sender/Preislisten/2022",
					"protocol": "https",
					"host": [
						"{{api_base_address}}"
					],
					"path": [
						"v1.1",
						"Sender",
						"Preislisten",
						"2022"
					]
				},
				"description": "Dieser Endpunkt liefert die für das angefragte Kalenderjahr alle relevanten Senderpreislisten zurück, wobei die letzte Preisliste pro Sender mit einem offenen GiltBis-Datum ausgegeben wird. Legacy bedeutet, daß die sogenannten \"Preislisten\" zur Abwärtskompatibilität bereitgestellt werden, in neuen Anwendungen aber besser nicht mehr verwendet werden sollten."
			},
			"response": []
		},
		{
			"name": "Zugeordnete Sender holen",
			"request": {
				"method": "GET",
				"header": [],
				"url": {
					"raw": "https://{{api_base_address}}/v5/Sender/Zugeordnet",
					"protocol": "https",
					"host": [
						"{{api_base_address}}"
					],
					"path": [
						"v5",
						"Sender",
						"Zugeordnet"
					]
				}
			},
			"response": []
		}
	],
	"auth": {
		"type": "oauth2",
		"oauth2": [
			{
				"key": "scope",
				"value": "RadioPPD.Services.Aktualisierung",
				"type": "string"
			},
			{
				"key": "clientSecret",
				"value": "E!nfach3sP8ssw()rt",
				"type": "string"
			},
			{
				"key": "clientId",
				"value": "Demo-Klient",
				"type": "string"
			},
			{
				"key": "tokenName",
				"value": "Demo Client",
				"type": "string"
			},
			{
				"key": "accessTokenUrl",
				"value": "https://idp.msw.de/connect/token",
				"type": "string"
			},
			{
				"key": "grant_type",
				"value": "client_credentials",
				"type": "string"
			},
			{
				"key": "addTokenTo",
				"value": "header",
				"type": "string"
			}
		]
	},
	"event": [
		{
			"listen": "prerequest",
			"script": {
				"type": "text/javascript",
				"exec": [
					""
				]
			}
		},
		{
			"listen": "test",
			"script": {
				"type": "text/javascript",
				"exec": [
					""
				]
			}
		}
	],
	"variable": [
		{
			"key": "api_base_address",
			"value": "audioppd.msw.de"
		}
	]
}